home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / GNUSED.ZIP / sed / README < prev    next >
Encoding:
Text File  |  1995-12-31  |  2.1 KB  |  61 lines
  1. * ABOUT BUGS
  2.  
  3. Before reporting a bug, please check the list of oft-reported non-bugs
  4. (below).
  5.  
  6. Bugs and comments may be sent to bug-gnu-utils@prep.ai.mit.edu.
  7.  
  8. Please do not send a bug report like this:
  9.  
  10.     [while building frobme-1.3.4] 
  11.     $ configure 
  12.     sed: file sedscr line 1: Unknown option to 's'
  13.     $ sed --version
  14.     GNU sed version 2.04
  15.  
  16. If GNU sed doesn't configure your favorite package, take a few extra
  17. minutes to identify the specific problem and make a stand-alone test
  18. case.
  19.  
  20. A stand-alone test case includes all the data necessary to perform the
  21. test, and the specific invocation of sed that causes the problem.  The
  22. smaller a stand-alone test case is, the better.  A test case should
  23. not involve something as far removed from sed as ``try to configure
  24. frobme-1.3.2''.  Yes, that is in principle enough information to look
  25. for the bug, but that is not a very practical prospect.
  26.  
  27.  
  28.  
  29. & NONBUGS
  30.  
  31.  `sed -n' and `s/regex/replace/p'
  32.  
  33. Some versions of sed ignore the `p' (print) option of an `s' command
  34. unless the `-n' command switch has been specified.  Other versions
  35. always honor the `p' option.  GNU sed is the latter sort.
  36.  
  37.  
  38.  regexp syntax clashes
  39.  
  40. GNU sed uses the Posix basic regular expression syntax.  According to
  41. the standard, the meaning of some escape sequences is undefined in
  42. this syntax;  notably  `\|' and `\+'.
  43.  
  44. As in all GNU programs that use Posix basic regular expressions, sed
  45. interprets these escape sequences as meta-characters.  So, `x\+'
  46. matches one or more occurences of `x'.   `abc\|def' matches either
  47. `abc' or `def'.
  48.  
  49. This syntax may cause problems when running scripts written for other
  50. seds.  Some sed programs have been written with the assumption that
  51. `\|' and `\+' match the literal characters `|' and `+'.  Such scripts
  52. must be modified by removing the spurious backslashes if they are to
  53. be used with GNU sed.
  54.  
  55. [If you have need of a free sed that understands the regexp
  56.  syntax of your choice, the source to GNU sed may be a good place to
  57.  start.  Consider changing the call to re_set_syntax in function main
  58.  in `sed.c'.  The file regex.h contains an explanation of the
  59.  supported syntax options.]
  60.  
  61.